XMLSocket.onConnect

Доступность

Flash Player 5.

Синтаксис

myXMLSocket.onConnect = function(success:Boolean) {
  // необходимый код
}

Параметры

success Булева величина, показывающая, установлено ли соединение (true или false).

Возвращает

Ничего.

Описание

Обработчик события; вызывается Flash Player когда запрос на соединение, посланный, используя XMLSocket.connect(), обрабатывается (успешно или нет). Если соединение установлено, параметр success имеет значение true; в противном случае success равен false.

По умолчанию никаких действий не выполняется, поэтому нужно использовать функцию, выполняющую необходимые действия.

Пример

Код в примере ниже показывает процесс замены функции метода onConnect по умолчанию на пользовательскую, реализующую простое чат-приложение.

После создания объекта XMLSocket при помощи конструктора, скрипт определяет функцию, которая будет выполняться при вызове обработчика onConnect. Функция определяет, что будет показано пользователю, в зависимости от того, успешно или нет прошло соединение. Если соединение прошло успешно, пользователи направляются в кадр с чат-окном (метка startChat). Если соединиться не удалось, пользователи видят кадр с описанием возможных причин ошибки (метка connectionFailed).

var socket:XMLSocket = new XMLSocket();
socket.onConnect = function (success) {
  if (success) {
    gotoAndPlay("startChat");
  } else {
    gotoAndStop("connectionFailed");
  }
}

Наконец, соединение установлено. Если connect() возвращает false, SWF файл направляется в кадр с меткой connectionFailed и onConnect никогда не вызывается. Если connect() возвращается true, SWF файл переходит в кадр с меткой waitForConnection, экран “Подождите”. SWF файл остается в кадре waitForConnection пока обработчик onConnect не будет вызван, а насколько быстро это произойдет зависит от латентности сети.

if (!socket.connect(null, 2000)) {
  gotoAndStop("connectionFailed");
} else {
  gotoAndStop("waitForConnection");
}

См. также

function, XMLSocket.connect()

Посмотреть комментарии LiveDocs

Предыдущая | Следующая | Оглавление